package cn.tedu.order.tcc;

import io.seata.rm.tcc.api.BusinessActionContext;
import io.seata.rm.tcc.api.BusinessActionContextParameter;
import io.seata.rm.tcc.api.LocalTCC;
import io.seata.rm.tcc.api.TwoPhaseBusinessAction;

import java.math.BigDecimal;

/**
 * TCC按照 Seata规则实现TccAction接口
 * 1.添加@LocalTcc注解
 * 2.添加三个方法 - - TCC方法
 * 3.第一个方法上添加 " 两阶段业务操作 " 注解,并指定后面两个方法的方法名
 * 4.在三个方法上添加 BusinessActionContext 参数,用来从第一个阶段向第二个阶段传递参数
 * 5.传递的参数数据,用@RequestContextParameter注解放入上下文对象
 *
 * @author 郭鲁政
 */
@LocalTCC
public interface OrderTccAction {
    /**
     * 第一阶段方法
     * 避开seata的BUG 订单数据一个一个单独传递,而不用封装的 Order 对象
     *
     * @param businessActionContext 上下文
     * @return
     */
    @TwoPhaseBusinessAction(name = "OrderTccAction", commitMethod = "commit", rollbackMethod = "rollback")
    boolean prepare(BusinessActionContext businessActionContext ,
                    @BusinessActionContextParameter(paramName = "orderId") Long orderId,
                    @BusinessActionContextParameter(paramName = "userId") Long userId,
                    @BusinessActionContextParameter(paramName = "productId") Long productId,
                    @BusinessActionContextParameter(paramName = "count") Integer count,
                    @BusinessActionContextParameter(paramName = "money") BigDecimal money);

    /**
     * 提交
     *
     * @param businessActionContext 业务操作上下文
     * @return
     */
    boolean commit(BusinessActionContext businessActionContext);

    /**
     * 回滚
     *
     * @param businessActionContext 业务操作上下文
     * @return
     */
    boolean rollback(BusinessActionContext businessActionContext);
}
